EXECUTE SAVE DIALOG
This command displayes a standard save file dialog and returns 1 if the user chose a valid name for a file or 0 if the user cancelled the dialog. The filename can then be retrieved with SAVE DIALOG FILENAME().

A filter string consists of a description and a mask separated by a vertical bar (|) character. Do not include spaces around the vertical bar. For example:
Text Files (*.txt)|*.txt
Multiple filters should be separated by vertical bars. For example:
"Text Files (*.txt)|*.txt|All files (*.*)|*.*
You can pre-select the filter which will be initially shown in the dialog with the Index parameter. Set Index to 1 to choose the first file type in the list as the default, or set Index to 2 to choose the second file type as the default, and so forth. If the value of FilterIndex is out or range, the first file type listed in Filter is the default.
To include multiple masks in a single filter, separate the masks with semicolons. For example
Configuration Files|*.ini;*.cfg
An empty filter string will display all files.

ARGUMENTS:
optional:
* Window Handle = Handle to the parent window
* Title = Title of the dialogs (defaults to "Save" if an empty string is passed)
* Dir = The initial directory (defaults to the current directory if an empty string is passed)
* Filter = The filter string (see remarks above)
* Filename = The default file displayed in the file name field of the dialog
optional:
* Index = The filter index (see remarks above)

RETURNS:
The filename the user selected or an empty string if the user clicked Cancel


SYNTAX
Return Integer=EXECUTE SAVE DIALOG([Window Handle,] Title,Dir,Filter,Filename [,Index])


RELATED INFO
View Dialogs Index
View STYX Index
View STYX Main File